Magnum One

home *** CD-ROM | disk | FTP | other *** search

/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / ommm_170.arc / OMMM.DOC < prev next >

Wrap

Text File | 1991-07-13 | 103KB | 2,767 lines

OOOOO MM MM MM MM MM MM OO OO MMM MMM MMM MMM MMM MMM OO OO MMMMMMM MMMMMMM MMMMMMM OO OO MM M MM MM M MM MM M MM OO OO MM MM MM MM MM MM OO OO MM MM MM MM MM MM OOOOO MM MM MM MM MM MM THE OPUS MATRIX MESSAGE MASHER For use with Opus CBCS Processes, compresses, routes and sends mail according to operator specifications. Version 1.70 July 14, '91 Table of Contents Introduction................................. 3 If You're New to OMMM or the Matrix New Setup from Scratch................ 4 The OMMM Configuration File........... 5 Command Line Switches................. 8 Setting up Errorlevels................ 9 OMMM Scheduling....................... 10 Working with HOLD & UNHOLD Verbs...... 11 The PreScanFile....................... 13 The Routefile......................... 14 ShortHand Commands.................... 16 News for Grizzled Veterans Day and Time in your Config........... 18 Day Stamping Extensions............... 19 Support for Points.................... 19 File Requests/File Attaches .......... 20 OMMM and OMMM286...................... 20 New Zone Commands..................... 20 Replaced Commands..................... 21 Zone Awareness Setup................................. 22 After a Zone message is entered....... 24 TechnoTalk How OMMM does what it does............ 25 Indexes Index A - Config Commands/Switches.... 28 Index B - Mail Packet Extensions...... 32 Index C - Schedule Verbs.............. 33 Index D - Dec/Hex Chart............... 39 Legal Department............................. 40 Glossary of Terms............................ 41 OMMM 1.70 Table of Contents Introduction What exactly is OMMM? It's the "Opus Matrix Message Masher", or perhaps stated even better; it's a way for your Opus system to handle it's own mail. Whether you send one Matrix message a month, or transfer echos daily between several systems, OMMM lets you set up your system to handle the mail the way YOU want it handled, without the use of any type of front end program. OMMM was originally written by Wynn Wagner III as part of the Opus CBCS package, and has always been an integral part of Opus. With the work of Jon Marshall and others, this new version has added day of week named packet extensions, day and time schedul- ing, point support, zone awareness, plus complete compression support through the "stuffer<tm>" command lines in it's con- figuration file. Because each Sysop is at a different level of experience, I've tried to create documentation that will satisfy everyone. There are those Sysops who were there at the start of this wonderful phenomenon who want to quickly learn about juicy new features. There are those who are setting up a board for the very first time, and don't care HOW the program works, but want the answer to that old question, "How do I set this thing up from scratch?" This documentation is dedicated to Wynn Wagner III with thanks, and to Mark Lymburner, with love. Tina Dougherty June '91 OMMM 1.70 Page 3 New Setup from Scratch ====================== +--------------------------------------------------------------+ | | | "It's important to set up your head for all of | | this before you set up your computer." | | | | - Wynn Wagner III | | Opus 1.0 docs | | | +--------------------------------------------------------------+ Ok, so you've set up most of your Opus board, and now want to be able to send mail to another system. OMMM, when setup cor- rectly, will bundle your mail, address it, and send it out ac- cording to specifics you've set. To setup OMMM, you're going to have to do five things: 1. Edit the OMMM.cfg to your preferences. This file comes with the OMMM program, and has many helpful comments already in it to provide extra information for you. 2. Setup your OMMM schedules. Having your schedules setup correctly is one of the keys to running OMMM correctly, and to having your board do what you want it to do WHEN you want it done. Read the sections on schedule verbs, and on the Routefile. 3. Edit your Nerf batch file to work with OMMM. The section of these docs on the use of errorlevel exiting will be helpful if this is a new concept to you. 4. Work with your Event Manager. After you've setup your schedules, you'll need to use your Event Manager to specify WHEN you want Opus to run OMMM and do it's thing to handle your outbound mail. 5. Choose either OMMM or OMMM286. (Both are included) This choice will depend on what type of processor you have. If you're running your board on a 286, 386 or 486 processor, rename OMMM286.Exe to OMMM.Exe. If you've never set up OMMM before, it's not hard, but IS going to take a bit of reading on your part. This section will lead you through setup as painlessly as possible. If you're an old hand at working with OMMM, and haven't jumped to the "Grizzled Veteran" section yet, do read through these docs to get some detailed ideas on what's new with 1.70. OMMM 1.70 Page 4 The OMMM Configuration File =========================== OMMM has one of THE most easy to understand config files because of all the helpful comments that are there for you. Your OMMM program comes with a sample OMMM.cfg that you can pull into your favorite word processor and edit to your specifications. Your word processor MUST be able to save in ASCII format. If you're new to config files for programs, you need to know that any line that starts with a word will be read by the pro- gram, and any line that starts with a symbol such as ";" is con- sidered to be "commented out". In other words, if you want to add some notes of your own, you can do that just by making sure that the ";" symbol is the first character on the line. You also use the symbol before a command or parameter if you don't want it to be read by the program. Here are the commands where you tell OMMM where to find info it needs about your system. Optional items are noted here with *: MESSAGEPATH - Path to your Matrix messages. HOLDPATH - Path to your outbound mail holding area. PRESCANPATH (*) - Path to your prescan routing file. ROUTEFILE - Fully pathed RouteFile name. ADDRESS - Your FULL address. This *MUST* show your Zone, Net, Node and Point number. If you don't have a number yet use 0:-1/-1.0 'til you get one. If you want to run in to run in Zone Aware mode, use the zone numbers. If you don't want to run in Zone Aware mode, use 0 for your primary zone number. Ex: 1:371/15.0 is Zone Aware 0:371/15.0 is NOT Zone Aware POINTNET (*) - Local pointnet if you're a Bossnode. More info on this command is available in the "Grizzled Veterans" section of these docs. SCHED (*) - Allows you to set up schedules so that OMMM does WHAT you want it to do, WHEN you want to do it. This is one of the most important parameters in your config file, and will be covered in-depth a bit later in this doc. If you're NOT a Bossnode, or don't use a PRESCANPATH, then sim- ply comment these lines out by putting the ";" in front of that word. In the sample OMMM.cfg, PRESCANPATH comes to you already commented out. Note that OMMM does have a minimum of information it needs to run. MESSAGEPATH, HOLDPATH, ROUTEFILE, ADDRESS, and at least one SCHED are all necessary fields that need to know where you're storing what. OMMM 1.70 Page 5 For each command, you must make the choice whether or not you want your board to use that particular option. You "toggle" these choices off and on by "uncommenting" the line by removing the ";" in front of the command. In addition to the lines listed above, here's a list of the com- mands available to you in OMMM config, and what each will do for you. (This info is also available with fuller explanations and examples in Index A of this doc.) FORWARD Toggles off the default of OMMM to forward mail and add to an existing bundle of a different type. (Hold, Crash, etc.) Be careful about turning off forwarding if you're a Host or Hub. MO? If you'll be communicating with an old Opus 1.0x board, or a mail system that doesn't understand the newer extensions, then use this switch. GATEROUTE Tells OMMM to route all your interzone mes- sage through the zone gates. NO_SCAN Will tell OMMM not to scan your Matrix area. OMMM will only scan your outbound area and do routing. QUIET Suppresses some of the displays, which makes for more speed, and a tidier screen. NORMAL Normalize all packets in the holding area so that those that are left with the LEAVE verb are sent. (The LEAVE verb is explained here in the section on Scheduling verbs.) MAXARC Used to specify the maximum compression size. The default is no limit. OLDBUNDLE # Will tell OMMM to delete bundles after they've been sitting around in your outbound area for too long. If you decide to let OMMM handle this, you must specify the number of days before a bundle is deleted. NO_DATE Disables the OMMM default to support the time/date stamping of Opus messages into FTSC for- mat for outbound mail. Use this ONLY if you're not using an Opus compatible message editor. NAKED Makes OMMM generate file requests understandable to mailers that treat .REQ files as normal mail rather than as a file request. If you're not running Binkley, don't use this option. REQUEST Toggles the new Opus (1.2x) file requesting options. If you're running Opus 1.2x, check out the new file extensions listed in the TechnoTalk section of this doc. OMMM 1.70 Page 6 OZONE Will let you hold off on processing Zone mail. With this option, mail in your matrix area will NOT be scanned. Use this if you don't want mail addressed to other zones scanned. At the bottom of your config file, you'll find all your "stuffer<tm>" options. These tell OMMM which compression pro- gram to use for compressing mail from your system. Choose ONE of the options as your default, and comment out the others. So, if you're going to use PKZip to compress mail from your board, it should look something like this: ;Define the "stuffer" program to use for creating compressed Define_Stuffer ZIP pkzip -a ;Define_Stuffer PAK pak a ;Define_Stuffer ZOO zoo -add The second set of stuffer<tm> lines enable you to define a spe- cific compression method for a specific system. Let's say you're a PKWare fan, and have chosen ZIP as your default. How- ever, you've got a friend who really prefers their mail to come in PAK'd. You can have OMMM PAK their mail by uncommenting the PAK line in the second stuffer<tm> set, and adding their address to that line. Example: ;Define a list of nodes to use with each stuffer<tm> Stuffer PAK 129/112 Stuffer ZOO 371/18 By using lines like these, 129/112 will receive their mail PAK'd, and 371/18's mail will be ZOO'd. Everybody else will re- ceive mail from your system ZIP'd. There's no limit to how many boards you can put in each line, other than DOS's limit of 512 characters. If you find that you need more than 512 characters on a line, feel free to use the same stuffer definition more than once. OMMM can handle it: Stuffer PAK 129/112 129/50 129/11 371/18 Stuffer PAK 129/26 Stuffer will work with ANY compression program that uses the same syntax as those found in your config file. If your favor- ite compression program can be setup like this: Name <options> compressed_file_name filename_to_be_compressed then it'll work in OMMM. Check into the config file, as just about every known compression program has already been listed for you to comment in or out. Don't Forget: Your compression method MUST be in your path! OMMM 1.70 Page 7 WARNING WILL ROBINSON, WARNING! Do NOT change the way a node has it's mail compressed while there's mail being held for that board. If you change a board's compression method while there's a packet sitting there, you'll end up creating a packet that will be garbage 'cause neither compression method will be able to open it. Command Line Switches ===================== There's another way you can have OMMM read your configuration choices. Take a REALLY close look at the QUIET toggle line in OMMM.cfg: QUIET ; -q from command line The "-q" is the command line switch this command. This means that you can either run: c:\opus\OMMM and have it read the toggles from your config file, or you can run: c:\opus\OMMM -q and have it read the toggles from your command line. This can come in handy for you if you want to run OMMM differently at different times. Basically, remember it this way...all the op- tions that you want OMMM to use ALL or MOST of the time, set them up in your config file. It's best to use command line switches only to over ride the configuration in special in- stances. REMEMBER: COMMAND LINE SWITCHES OVER RIDE THE CONFIG SETUP. So, if you ALWAYS want to run OMMM in Quiet mode, uncomment the Quiet line in your config. When we get into setting up sched- ules, you'll see how you can use the command line switches to over ride the config in special cases. You'll also see how you use the command lines to run a specified SCHEDULE at a specified time. OMMM 1.70 Page 8 Setting Up Errorlevels ====================== So, how can you use the command line switches to run OMMM to your specs when you want them run? The answer is errorlevels. You're going to need to setup errorlevels in your Nerf.bat (aka Runopus.bat) to let OMMM know what to do and when. You've already setup some exiting errorlevels in your Opus con- trol file to tell Opus what to do when a caller exits. Now, you tell Opus what to do when it gets to that errorlevel. You use errorlevels, OMMM command lines, and the OMMM SCHED command in conjunction with your Event Manager to have OMMM run certain schedules. This is done either when Opus exits at a specific errorlevel, or at specific times of day. The key to successfully using OMMM is to set up the errorlevels correctly, so they call the OMMM schedule you want, when you want it to be run. Go into your Nerf.bat, and setup an "If ERRORLEVEL ## Goto" line to be run when a caller hangs up. This MUST match the error- levels you told Opus to use when you set up your control file. Let's say that when you setup your Opus board, you told Opus to use: AFTER Call Exit 12 (somewhere near line 245 in bbs.ctl) Here's what a BARE BONES Nerf.bat would look like: @Echo Off Cls C: CD\Opus :START Opus BBS :LEVEL If errorlevel 255 goto start Errorlevel here -------> IF ERRORLEVEL 12 GOTO MAIL If errorlevel 5 goto start If errorlevel 4 goto start If errorlevel 3 goto error If errorlevel 2 goto start If errorlevel 1 goto end :ERROR Echo Echo Serious Error - Opus Halted. Goto end Sends Nerf.Bat Here --> :MAIL Runs Schedule E ------> OMMM -sE Goes back to Start ---> Goto Start :END CLS OMMM 1.70 Page 9 Using this example, the board would exit at an errorlevel of 12, as you told it to do in your bbs.ctl. This errorlevel is caught by the batch file, which makes it "goto MAIL". The MAIL part of the batch file runs OMMM for Schedule E. (The -sE switch in the command line tells OMMM to run Schedule E). The next line then returns the board to START, so it'll be ready for the next caller. Remember, command line switches over ride the config file, so if you've got QUIET mode commented out in your config file, but add a "-q" to your command line, that particular run of OMMM will run in QUIET mode. So, we've exited and told OMMM to run Schedule E. How do we set that up? Scheduling ========== We've called for Schedule E to be run in the example, so we have to tell OMMM what we want it to do for Schedule E. This is ac- complished with your SCHED lines in your config file. Putting all of your scheduling information in the OMMM.cfg is now fully supported and easy to use, although the Routefile is still supported. IMPORTANT: OMMM must have at least one Sched- ule in the config file, and it will also be looking for the RouteFile you specified. Since you MUST have at least one SCHED statement in your OMMM config, and since OMMM will be looking for the RouteFile you specified in your config, let's (for now) set up a Schedule E in both places. Schedule E will handle any mail that was entered while a caller was on-line. This would be a "normal exit after caller", or what your system would normally do when a caller hangs up. Create a very simple RouteFile with the name you specified in your OMMM config (something like ROUTE.CTL) that includes lines like these, then add edit the SCHED lines in your config file. Use a schedule similiar to this, substituting boards you're in contact with in place of 129/112 and 371/18: ;Normal Exit After Caller SCHED E ONEHOLD 129/112 371/18 ONEDIRECT All The words: SCHED, ONEHOLD and ONEDIRECT are just a few of the Scheduling Verbs, and they're what allows you to setup OMMM to handle mail to any board you want. Each Scheduling Verb can be used to specify ONE board, or to list many boards. OMMM 1.70 Page 10 This particular Schedule E causes any mail destined for 129/112 or 371/18 to be put on HOLD, and to have it's files processed individually. (You'll learn more about this in Index C, Sched- ule Verbs). The ONEDIRECT ALL statement at the end of the schedule serves as a catchall for any unrouted bundles sitting in your outbound area, so that they'll be directed to the cor- rect system. There are many Scheduling Verbs available to you, and each will cause mail to the boards you've listed to be handled as you specify. Please read Index C carefully so that you can have OMMM correctly handle mail for your board. The HOLD and UNHOLD Verbs ========================= Let's take a minute to talk about the HOLD command. Mail you've marked HOLD will take up permanent residence in your outbound area until one of four things happen: 1. It's picked up by the destination board. 2. Your board UNHOLDS it, so it can be sent. 3. It's deleted by the OLDBUNDLE (-t) command. 4. It's deleted manually by you. Option #4 doesn't mean that you'd delete the message from your board, but that you'd actually go into your outbound manager, or the outbound area itself and delete the mail packet. PLEASE resist any and all temptation to futz with the files in your outbound area until you know EXACTLY what you're doing. It used to be that HOLDing and UNHOLDing mail was pretty much determined by when the destination board could handle an incom- ing call. Nowadays, most boards can handle incoming mail at any time of day, so you want to concentrate on sending mail when it's the cheapest for you. This harkens back to the way you've setup to process your nodelist, and to setting up your OMMM. So, if you're going to send some long distance mail, rather than have it picked up, you'd want your board to know to HOLD all mail for long distance/tollcall boards until it's the right time to UNHOLD and send them. Let's say that you've setup your files like the examples above (substituting a board that you'll be contacting in place of the 129/112 and 371/18 shown). Go into your board and enter a net- mail message to the board you've specified to have their mail marked for HOLD. Say Good-bye, and watch OMMM do it's thing. What happens is that when you sign off (either remotely, or from local keyboard), Opus finds the "if errorlevel 12 goto" line, and runs the OMMM line that includes Schedule E. So, the mail to the system(s) you specified in Schedule E with the ONEHOLD command are now sitting on hold. OMMM 1.70 Page 11 What you should end up with is a mail packet that's on HOLD. You can check this by reading the packet's extension, but since we haven't gotten that far (yet), use oMAN or your outbound man- ager to check on what's in your Outbound area. You should have a set of files that are marked as HOLD in the Status column. If not, go back and check everything you've setup. (Spelling counts). So, now you've got this mail sitting in your Outbound area. Since you now know that HOLD mail won't be send, what do you do with it? That depends on whether you're responsible for sending it, or if another board is going to call yours and pick it up. If you're going to have to send it, how do you get OMMM to UNHOLD that mail? You run another errorlevel, with another Schedule. Using your Event Manager, set up a new event with an errorlevel you've not used in your Opus setup, and one that's NOT reserved for use by Opus. Opus reserves errorlevels 0-4 and 255 for it's own use. You'll also need to setup the Start and End times of the event for 11pm (23:00). Now go to your Nerf.bat, and add the errorlevel line: IF ERRORLEVEL 50 GOTO CHEAPER And it's corresponding "goto" line: :CHEAPER OMMM -sC Goto Start and then setup a Schedule C in your OMMM config file: ;Call Chuck at 11pm SCHED C UNHOLD 129/112 POLL 129/112 ONEDIRECT All When the event is run, it'll exit at the errorlevel you specified in your event setup. The command UNHOLD will change the mail packet so that it's not on HOLD anymore. When Opus sees this packet isn't on HOLD, it'll call the destination board to send the mail. The POLL command is used incase you've agreed to call this board whether or not you have mail waiting for it. The POLL command will cause your board to call the board you've specified to be polled. Not only can you have schedules run just specific tasks where you set the time by errorlevels, but you can specify days of the week, and start and end times for them. We'll be covering that aspect of the Schedule file in the section on enhancing your OMMM setup. OMMM 1.70 Page 12 The PreScan File ================ There are two things you should keep in mind about the PreScan file: 1. The PreScan file is rarely used. It's available to you in OMMM.cfg, and can be added on the command line with the switch -p (Example of command line: -pC:\OPUS\PRES.CAN) 2. If you choose to use it, you must remember that commands in this file will be run BEFORE ANY of your schedules. Be- cause it is run on ALL mail in your outbound directory, and because it is run before any of the schedules, it is either extremely helpful or downright dangerous. Make SURE you know what you're doing before deciding to run a PreScan file. Quoting Jon Sabol on what the PreScan file does: "<The PreScan File> allows you to convert the outbound area to a normal state prior to running the event. I don't use a prescan file. I let the routing statements correct themselves. Prima- rily, the PreScan file is to allow you to un-LEAVE nodes that have been marked as no-send. Other than that, you are on your own to decide what the prescan does. Here are some examples: UNCRASH ALL Will change any CLO,CUT files into FLO,OUT files. Useful if you need to UNCRASH any nodes. UNHOLD ALL Will change any HLO, HUT files into FLO,OUT files. Useful if you need to UNHOLD any nodes. UNCRASH ALL UNHOLD ALL ONECRASH ALL Will change ALL outgoing mail that has not been routed to CRASH. Useful to create archives that are marked CRASH for all the boards listed. UNCRASH ALL UNHOLD ALL ONEHOLD ALL Will change ALL outgoing mail that has been routed to HOLD archives. Useful to create archives that are marked HOLD for all the boards listed." To fully understand what Jon has said about PreScanning, check into the commands he's used. All commands are listed here in Index C. OMMM 1.70 Page 13 The RouteFile ============= The RouteFile is simply all your Schedules in one file that you can create with any ASCII text editor. To OMMM, having this file named (and fully pathed) is essential, whether you choose to define it in the OMMM config or on the command line. The RouteFile must exist, either pathed in your OMMM.cfg file, or given on the command line with the "-c" switch. OMMM config must have at least one schedule in it. This gives you the free- dom to put all used schedules in one place or the other, or di- vide them between both files. Some Sysops will want to put all the schedules in the RouteFile, and not have them listed in the OMMM config. That's fine and will work as long as you remember that OMMM config must have at least one schedule in it. This doesn't mean it has to be one that is ever run. For example, you could put a schedule Z in your OMMM config, and simply never call for that particular schedule. If you'd prefer to have all of your schedule info in the OMMM config, do the exact opposite. Put all your schedules that are run in OMMM config, and one that's never called in the RouteFile. To create a simple RouteFile which we'll call Route.ctl, add the name to your ROUTEFILE line in OMMM config. With the name of Route.ctl, it would be added to the OMMM config like this: ROUTEFILE c:\opus\Route.ctl Or, call it from the command line: OMMM -cC:\OPUS\ROUTE.CTL Then, create your file using any ASCII text editor (even Edlin if nothing else is handy.) Here's a simple, sample RouteFile: SCHED E ;The fault schedule - Normal Exit after caller OneHold 129/112 129/11 129/50 129/26 OneDirect All SCHED C ;Poll Chuck after 23:00 UnHold 129/112 Poll 129/112 OneDirect All SCHED N ;National Mail Hour 4-5 am EST 5-6 am EDT Unhold All OneHold 371/All 129/All OneDirect All OMMM 1.70 Page 14 Setup your Schedules either in your config file, or your RouteFile so that you hold mail for systems that call you for mail, and for those systems that you only want your computer to call at certain times. DON'T SKIP THIS SECTION, IT'S IMPORTANT: The important thing to remember about OMMM when working with the RouteFile, and with OMMM config, is that it's a PRODECURAL pro- cessor. It will run command 1, then 2, then 3, etc. To make it simple, what this means is that you should deal with specific boards first, then use any shorthand command(s). Since my Netnumber is 371/15, I have mine set like this: HOLD 129/112 ONEDIRECT ALL If I had it bassackwards: ONEDIRECT ALL HOLD 129/112 Then the mail for 129/112 would NOT be put on hold, because it was already a direct bundle. I'd have to go in manually via oMAN or my outbound manager and change this bundle to a HOLD. Since the idea of OMMM is to let it deal with the mail for you, that's not a very tasty solution. OMMM 1.70 Page 15 Shorthand Commands ================== There are many ways to add to your OMMM setup, and these are ac- complished mainly through Scheduling correctly. For example, if you know that you're going to be sending mail to different members of the same net, and they're all long distance calls, you can either specify each one in your RouteFile, or use a bit of OMMM shorthand. For example, you could have the line: ONEHOLD 129/112 129/11 129/50 129/26 * OR * ONEHOLD 129/All The commands: ALL WORLD NET??? are used when you want to specify groups of nets. For example: 129/ALL 129/WORLD NET129 are all valid commands that tell OMMM that you're referring to every system listed in the Nodelist as a member of Net 129. Other shorthand commands are OURNET and OTHERS. Both will refer back to your primary Net Number. My primary NetNumber is Fido 1:371/15, so if I have the line: HOLD OURNET in a Schedule, that means that I want to HOLD any mail for any board in Net 371. The OTHERS command is the exact opposite, as it means every board OTHER than those in your primary net. So, if I have the line: HOLD OTHERS in a Schedule, it would set all mail to every board that's NOT in Net 371 to HOLD. In addition to shorthand commands, there are other ways in which to customize your OMMM setup so that it'll tap dance if you like. (well, not really, but darn close.) These ways are your OMMM config file, and your schedules setups. OMMM 1.70 Page 16 Once you've got a basic setup running on your board, take a close look at Indexes A and C of this doc. Index A is a concise guide to the commands available to you through OMMM config and/or the the command line. Index C is a list of all the schedule commands, and what each will do for you, along with some tips on how to use them. You may also want to check through the "Grizzled Veteran" section, to learn about day and time commands that are a new feature of OMMM version 1.70. Please keep in mind though, the immortal words of Wynn Wagner when he was talking about schedule commands: "In most cases, you can lead a fruitful/meaningful life with nothing more complicated than those <three or four commands>. All of the other words are for advanced usage or for special circum- stances. (K.I.S.S!)" So, though OMMM has the power to handle all mail chores for a board that NEEDS an extremely complicated setup, that doesn't mean you need to MAKE your setup extremely complicated. OMMM 1.70 Page 17 News for Grizzled Veterans - Juicy New Features of 1.70 ======================================================= +--------------------------------------------------------------+ | Oh well a touch of grey, | | kinda suits you anyway. | | - Touch of Grey | | The Greatful Dead | +--------------------------------------------------------------+ Date and Time ============= The ability to add day and time parameters to your Schedules is now available. This can be particularly helpful to set up OMMM for something like National Mail Hour. SYNTAX: SCHED <tag> <day> [<start_time> <end_time>] EXAMPLE: SCHED N All 04:00 05:00 ; National Mail Hour Valid days are: All Every Day Tue Tuesday Only Week Week Days Only Wed Wednesday Only WkEnd WeekEnds Only Thu Thursday Only Sun Sunday Only Fri Friday Only Mon Monday Only Sat Saturday Only If you'd want to run a schedule on Wednesdays and Fridays, you can do that with the "|" symbol to join days in the same Sched- ule. For something like this, you'd enter the days as Wed|Fri, and that Schedule would only be valid on those days. Starting and ending times use military time: 00:00 Midnight 08:00 8am 16:00 4pm 01:00 1am 09:00 9am 17:00 5pm 02:00 2am 10:00 10am 18:00 6pm 03:00 3am 11:00 11am 19:00 7pm 04:00 4am 12:00 Noon 20:00 8pm 05:00 5am 13:00 1pm 21:00 9pm 06:00 6am 14:00 2pm 22:00 10pm 07:00 7am 15:00 3pm 23:00 11pm So a Schedule set for 20:00 23:30 would run from 8pm to 11:30pm. Also new in the category of "Time" is that OMMM now automagically stamps FTSC format time/date on outgoing mail packets. Only disable this if you're not using an Opus compat- ible message editor. (Use NO_DATE or -d to disable). OMMM 1.70 Page 18 Day Stamping ============ OMMM now supports the proper day stamping of compressed mail: MO?, TU?, WE?, TH?, FR?, SA?, and SU?. The "?" equals a number from 0 to 9, depending on how many packets you've put together for that system that day. This type of extensioning is only done if you've commented out the MO? command in the config, or haven't overridden it with the -o parameter. There's ONE exception to this rule though: if you're using MO?/-o, AND have set a size limit, then OMMM could possibly get to MO9, and have it exceed your set size limit. If this happens, then OMMM will automagically override your deci- sion to use the older standard, and name the next bundle TU0. POINTS ====== More and more Sysops are starting out as "Points" to established systems (Called a "Bossnode" when they have a Point or Points running under their supervision). Some nets are encouraging new Sysops to serve as Points before joining the net as a full fledged system. Until recently, Opus and OMMM didn't have full support for this type of operation, but you can now set up your OMMM to reroute mail to Points. To enable this, use the POINTNET line in OMMM config: POINTNET ### where ### is the network address the message is to be rerouted to. So if my address is 109/315, and a message is found ad- dressed to me as 109/315.2, and I have POINTNET 0 in my config file, the message would be automagically rerouted to 0/2. Message to: Zone:Net/Node.Point Re-Route to: Zone:Net/Point Quoting Jon Marshall in the OMMM History file: "It is rumored that Opus will support points using WaZoo/Yahoo protocol with a rerouted message going to a network address of 0. In the above example, if another Opus calls me with an address of 109/315.2, any outbound mail for 0/2 will be sent. In testing, the point network address needs to be -1 for Opus 1.1x to work this way." OMMM 1.70 Page 19 File Requests ============= OMMM will now support Opus 1.2x's new file request features. This'll allow you to control WHEN you want to send file requests as well as receive them. It'll also help to prevent file re- quests during National Mail Hour. Use the REQUEST line in OMMM config, or the "-y" on the command line to toggle it on. See Index B for a list of mail packet extensions used with this feature. File Attaches ============= You can file attach messages with file names beginning with ^ or #. The beginning character determines how OMMM will handle the file after it's been sent: ^ will be deleted after being sent. # will be 0'd out (to 0 bytes in length) after being sent. OMMM will also allow you to do wildcard file attaches and mul- tiple file attaches where each file is separated by semicolon, a comma or a space. Your message editor might hiss at you about this, but OMMM will expand the information out so your mailer will pick it up. OMMM and OMMM286 ================ As of 1.70, OMMM will include two versions of the program. OMMM is for those who aren't running with an 80?86 processor, while OMMM286 is for those who are. If you're running on a 286 or 386, a good suggestion would be to either delete or rename OMMM.Exe, then rename OMMM286.Exe to OMMM.Exe. No_Scan ======= OMMM now gives you the ability to choose NOT to scan your Matrix area. Using the new No_Scan or -j switch will cause OMMM to only scan your outbound areas and do routing. OZone Scanning ============== The new OZone or -z command will let you hold off on processing Zone mail. With this option, mail in your matrix area will NOT be scanned, so use this if you won't want mail addressed to other zones scanned. Command Line Switch Over Ride ============================= ALL command line switches now over ride the config file. OMMM 1.70 Page 20 Replaced Commands ================= ARC Routing Verbs ================= They be gone! The ARC and ZOO routing commands have been re- placed with the STUFFER verbs. Here're the conversion equals: ARCCM is now STUFFCM ARCDIRECT is now STUFFDIR ARCHOLD is now STUFFHOLD ZOOCM is now STUFFCM ZOODIRECT is now STUFFDIR ZOOHOLD is now STUFFHOLD VERB COMMAND ==== ======= INFO_PATH -i Gone completely. DOCM Gone completely. ZONE -z Formerly used to specify Zone Aware mode, the -z is NOW used for OZONE, or holding zone mail that you don't want scanned right away. Use 0 for your zone ADDRESS to disable zone. Use # for your zone ADDRESS to enable zone. NO_ADD -u Formerly used to determine whether OMMM would add to existing bundles, this command is gone. OMMM 1.70 Page 21 Setting up for Multiple Zones ============================= +---------------------------------------------------------------+ | Her name was McGill, | | And she called herself Lil, | | But everyone knew her as Nancy. | | - Rocky Raccoon | | The Beatles | +---------------------------------------------------------------+ With the release of Opus-CBCS 1.20, Opus is now fully Zone aware! To setup for Zone awareness you have to do each of the following items: 1. Tell Opus all of your addresses. This is done in the BBS.Ctl, and all addresses must be fully listed including zone, net, node and point. Remember that the FIRST address listed will be your Primary address. Your Primary address MUST be the same in Opus, OMMM, and in the nodelist compiler of your choice. The order of your other addresses (if any) can be in any order you like, but your Primary address must always be listed first: ADDRESS 1:371/15.0 ADDRESS 69:2304/1.0 ADDRESS 45:570/103.0 ADDRESS 30:30101/15.0 2. Edit any of your echo areas which will be exchanging mail with other Zones. In the message area, it's only your ADDRESS line which reflects the Zone. Don't try to put the Zone number in your SCAN line. If you do, Opus will burp and spit and say bad things about you. Here's an example of an echo setup that I use to exchange mail within Zone 69: AREA 0102 REVIEW SECTION O PUBLIC MESSAGES ONLY ANONYMOUS OKAY ECHOMAIL A_REVIEW ACCESS PRIV Privil PEEK PRIV Sysop PATH G:\MSG\AREVIEW\ TITLE Over18 Movie Reviews MAXLINES 60 ADDRESS 69:2304/1.0 ORIGIN The Emerald City - Ft. Myers, FL SCAN 2304/18 END AREA Opus will automagically include my Adult Links (Zone 69) ad- dress in the origin line, and will know that this echo is Zone 69 bound. Which leads to the point that you can't share echos inter-zone. Putting the Zone in your message area ADDRESS line will give Opus the Zone to send to, so whatever boards you list in the SCAN line must be in the same Zone as your message area OMMM 1.70 Page 22 ADDRESS. Omitting the Zone will cause Opus to default to the Primary Zone. (You knew you'd see that term again, didn't ya?) Once you've got all the echo areas setup, re-Salt your control file, and move on to telling OMMM what's going on. 3. Tell OMMM all of your addresses. This is done in the OMMM.CFG, or with the "-a" switch on the command line. Same as with the Opus control file, all addresses must be fully listed: ADDRESS 1:371/15.0 ADDRESS 69:2304/1.0 ADDRESS 45:570/103.0 ADDRESS 30:30101/15.0 While you're in OMMM.Cfg, you can decide which (if any) of the Zone commands you want to use. The NO_SCAN (-j) and OZONE (-z) switches are available if you decide to only handle specific Zone processing at specific times. If you're just setting up for Zones for the first time, a suggestion would be to not use either of these switches until you've decided how you'll want them to work for you. 4. Let your Route.Ctl file know what you're doing. Unlike the Opus SCAN line, you DO include the Zone number here if it's different from your Primary Zone. You don't need to include the Zone number for your Primary...that's your automagic de- fault: SCHED E ;Normal Exit after caller OneHold 129/112 30:30101/18 OneCM 69:2304/18 OneDirect All 5. Compile your nodelist using the compiler of your choice in Zone Aware mode. Check the documentation of your compiler to setup it's config correctly so that your nodelist.idx and nodelist.dat files include the Zone specifics. If you don't compile your nodelist to include the Zones, none of the other adjustments you've made will do you any good, and will only confuse everybody involved. 6. Create separate outbound directories for each Zone. Your pri- mary address will be handled by your main outbound directory (usually C:\OPUS\OUTBOUND), but each other zone must have it's own. This is done by using extensions made from the hexidecimal value of the Zone. Use the conversion table avail- able here (Index D) to find the correct Hex values for your zones. Example: C:\OPUS\OUTBOUND\ For Primary Zone 1 C:\OPUS\OUTBOUND.045\ For Zone 69 C:\OPUS\OUTBOUND.02D\ For Zone 45 C:\OPUS\OUTBOUND.01E\ For Zone 30 OMMM 1.70 Page 23 6. Check what you've setup by going into your board and entering a message to a board in another Zone. In your Netmail area, en- ter the message to the correct board INCLUDING the Zone number. If Opus tells you that it can't find the address, go back and check everything you've done. (Spelling still counts). What Happens Next ================= Once you've entered your message and Opus has found the address, hang up and watch OMMM go to work on it. You'll see something like this, which I see when I enter a message to 69:2304/18: Reading OMMM.cfg file OMMM processing schedule 'E' Quiet Mode Scanning mail area... 102 ... To: 69:2304/18 (CM) Go into your Matrix section, ("M" if your board is sitting READY), and ask for I)nfo, you should see that the mail is sitting in the correct directory, and has it's Zone number noted: CRASH/SPEW ATTACHES: C$ 69:2304/18 #C:\Opus\Outbound.045\09000012.CUT Opus will call the board, and will present YOUR address that matches the Zone of the intended board. Note line #4: 1. OPUS Calling 69:2304/18 Mental Floss (2755410) 2. OPUS Connect 9600/Arq 3. OPUS Responding to: 69:2304/18.0 4. OPUS Responding as: 69:2304/1.0 5. OPUS /\/\ENTAL FLOSS (69:2304/69.0) 6. OPUS Password-protected session 7. OPUS Throughput = 280 bps (3) 8. OPUS DL-Z C:\Opus\Outbound.045\09000012.CUT 252 9. OPUS Connect: 0:23 10. OPUS End (1) Basically, Zone awareness is simply making sure that your board knows the different names for the same thing. I send mail to 1:371/18, 69:2304/18, 69:2304/69 and 30:30101/18. They're all different names for the same board. Another example would be if you were to play these docs backwards, you'd find out that Wynn Wagner III, Zaphod Beeblebrox and Jon Marshall are all the same person. This isn't recommended though...it might cause unwanted demons to appear. :) OMMM 1.70 Page 24 TechnoTalk ========== How OMMM Does What It Does ========================== So, what exactly happens after a message is entered, and OMMM processes the mail according to your setup? Well, after the caller exits, and the computer is done burping and spitting, look into the directory you specified in your OMMM config as HOLDPATH. If you're not zone aware, this is where all outbound mail goes no matter how it's going to be handled. You're gonna some weirdly named files there, and though you won't understand them (but read on) OMMM understands them, because it's the one that named them. AGAIN, please don't muck with these files unless you know exactly what you're doing. If you MUST delete or rename a file, it's much easier and safer to do with an out- bound manager program. To understand what the scheduling verbs do for you, it's impor- tant to understand how OMMM uses the names and extensions of the files: The name of the file is used to tell WHERE the mail is going. The name of the extension is used to tell HOW it's going there. Let's peer into my outbound directory for a second and take a look at the files that OMMM created when it scanned the mail: 00810070.HLO 00F2FF9F.MO1 Both of these files were created when I entered the Matrix mes- sage to 129/112, and both are critical to making sure that the mail is sent correctly. The name of the first file is the address of it's destination in hexidecimal (base 16). In this case, it's 0081/0070 in hex, or 129/112 in decimal. This file is commonly called a File Attach file or a FLO file. The File Attach name comes from the fact that this is a small ASCII file that simply notes which mail packet(s) to send to the destination. The FLO moniker comes from the extension name FLO, which is a Normal attach file. HLO is the extension for an attach file that's on HOLD. (See Index B for a complete list, suitable for framing.) This file acts as the "marker"...it tells your board WHERE to send the mail. If you were to type this file to the screen, you'd see that it's a simple ASCII file that shows the com- pletely pathed names of all packets to send to the address, in- cluding the names of any files you want to send along with messages.. The lines listed inside this file are usually pre- ceded by the "#" symbol, which tells OMMM to truncate the mail packet itself to 0 bytes after it's sent. This helps to keep your outbound area from eating up all your disk space. OMMM 1.70 Page 25 The "stuffed" mail itself is in the second file shown, and OMMM uses a different method for the name and extension. These bundles are named for the difference between the board's num- bers, so 00F2FF9F.MO1 is the actual message bundle that's on HOLD TO 129/112 FROM 371/15. That's how your board knows WHICH board has sent you a bundle. (Your system does the math, you don't have to worry about adding and subtracting in hexidecimal). In the case of the mail itself, the extension is used to tell what day of the week it was put together (new style extensions) and number of packets inside. (Both old and new style). When you run your schedules to change the way the mail is handled, you're dealing with the extension on the "marker" file. It's these extensions that tell OMMM exactly how you want the mail to be handled. So, when you tell OMMM to UNHOLD mail, the program changes the extension on this "marker" file from .HLO to .FLO. Sure, you can do this manually, but setting your alarm clock to wake you up at 4am to change file extensions isn't gonna do your home life any good. Let's say you've agreed to call a specific board every Monday night to exchange mail. You want to call this board, whether or not you have mail for them. Let's see how OMMM would handle this. For starters, since you've agreed to call this board once a week, we'll say you HOLD mail for them until you call. So, if mail to this board has been entered, you have a packet that's been marked as HOLD. The marker file is sitting there with the extension of HLO. Now, you run a schedule who's first line says to UNHOLD mail to this board. OMMM changes the extension to FLO. Because this mail packet is now marked with a FLO exten- sion, Opus will call the board. Opus recognizes the FLO, CLO, DLO and HLO extensions, and will call the board who's address makes up the name of the file with any of those extensions. So, when UNHOLD changes the extension, your board will call out, de- liver this mail, and pick up anything for your board that the Sysop there has on HOLD for your board. But, what happens if you DON'T have any mail waiting for this board? There's nothing there for you to UNHOLD to create a FLO file. This is where the POLL command in a schedule comes in. POLL will create a "dummy" file with the extension of FLO, which will cause your board to call out. So, a good schedule for something like this would look like: SCHED C UnHold 129/112 Poll 129/112 OneDirect ALL Since you're reading this rather dry section of the docs to find out HOW OMMM does what it does, let's take a look at how OMMM manipulates the extensions in this schedule. OMMM 1.70 Page 26 UNHOLD 129/112 Will change any mail for 129/112 that has a HLO extension to a FLO extension. FLO is the extension for a normal file, which causes Opus to try to send it. If there IS a file there for 129/112, you now have a file with the FLO extension, and your board will call 129/112 to send this mail (and pick up any HOLD mail waiting for you). POLL 129/112 This will cover you incase you DON'T have any mail waiting to be sent to 129/112. The POLL command will create a dummy FLO file if it can't find a file with the extension of FLO, DLO or CLO. (Normal, Direct or Crash). This will make your board call 129/112, even if you don't have any mail for him...but just want to get any mail waiting for you to pick up. ONEDIRECT ALL This command is used for systems that you know CAN'T accept mail at all times of day (a board that CAN accept mail all day is know as supporting "Continuous Mail") and for boards that you're not sure as to their mail receiving capabilities. This is actually a holdover from old BBS systems that couldn't (or weren't set up by the Sysop) to accept mail at any time of day. Though most boards now can and do accept incoming mail all day, there are some boards that don't. So, this command is an excellent "catch-all" to handle mail for systems you haven't specified indi- vidually. Though YOU don't need to know all the extensions and what they do, OMMM uses this info to make sure your mail goes out to the correct board, at the correct time. Remember, you're completely in charge of this, and control it by the way you setup your schedules. OMMM 1.70 Page 27 Index A - Config Commands & Line Switches ========================================= --------+------------+----------+------------------------------------------- Switch | Name | Required | Examples --------+------------+----------+------------------------------------------- -m |MESSAGEPATH | Y | In OMMM.cfg: MESSAGEPATH C:\MSG\NET | | | On command line: -mC:\MSG\NET This tells OMMM where your Matrix (Netmail) area is. It's the same directory you specified when you set up your board. --------+------------+----------+------------------------------------------- -h | HOLDPATH | Y | In OMMM.cfg: HOLDPATH C:\OPUS\OUTBOUND | | | On command line: OMMM -hC:\OPUS\OUTBOUND This is the path to your outbound message hold area. You only specify your primary outbound path, even if you're running multiple Zones. You can use this switch from the command line to spec the directory where all of your mail will be placed after processing. You must specify a holding area either from the command line, or in the OMMM config. --------+------------+----------+------------------------------------------- -p |PRESCANFILE | N | In OMMM.cfg: PRESCANPATH C:\OPUS\PRES.CAN | | | On command line: -pC:\OPUS\PRES.CAN This is a non-mandatory file that enables you to have OMMM scan BEFORE the schedule you'd specified for that exit is run. Read the section on this file CAREFULLY if you decide to use it. --------+------------+----------+------------------------------------------- -c | ROUTEFILE | Y | In OMMM.cfg: ROUTEFILE C:\OPUS\ROUTE.CTL | | | On command line: OMMM -cC:\OPUS\ROUTE.CTL The complete path to your RouteFile may be added via the command line. The example shown is for the file Route.ctl which is in the C:\OPUS directory. --------+------------+----------+------------------------------------------- -a | ADDRESS | Y | In OMMM.cfg: ADDRESS 0:371/15.0 | | | On command line: OMMM -a0:371/15.0 This is your board's address. You list your primary address first, using 0 for zone if you're not operating in zone aware mode. To operate in zone aware mode, use the zone number. You list your aka(s) under your primary. If you're not in zone aware mode, OMMM will default to the primary number. OMMM 1.70 - Index A Page 28 --------+------------+----------+------------------------------------------- Switch | Name | Required | Examples --------+------------+----------+------------------------------------------- -f | FORWARD | N | | | | This switch is used to toggle off the default of OMMM to forward mail, and to add to an existing bundle of a different type. Be careful about telling your board not to forward mail if you're a Host or Hub. --------+------------+----------+------------------------------------------- -o | MO? | N | In OMMM.cfg: MO? | | | On command line: OMMM -o Older versions of OMMM used file extension names of MO#, where the "#" was the number of packets packed for that destination system that day. In the older format, MO does not stand for "Monday", but for Mail Out. You can force OMMM to use the newer version extensions, which are named according to days of the week. New style extensions: MO? TU? WE? TH? FR? SA? and SU?. If you communicate with an older Opus 1.0x board, or a mail system that doesn't understand the newer extensions, then use this switch by uncommenting it in the OMMM.cfg, or adding it to your command line. --------+------------+----------+------------------------------------------- -g | GATEROUTE | N | | | | Tells OMMM to route all of your interzone messages through the zone gates. If you're not operating in zone aware mode by specifying an address with a zone, then OMMM automagically operates in gate mode. --------+------------+----------+------------------------------------------- -j | NO_SCAN | N | In OMMM.cfg: NO_SCAN | | | On command line: -j This tells OMMM not to scan your Matrix area for messages. It will only scan your outbound areas and do routing. --------+------------+----------+------------------------------------------- -q | QUIET | N | | | | Operating in quiet mode suppresses the display of some screens, which makes for a bit more speed, and a tidier screen. OMMM 1.70 - Index A Page 29 --------+------------+----------+------------------------------------------- Switch | Name | Required | Examples --------+------------+----------+------------------------------------------- none |POINTNET -1 | N | In OMMM.cfg: POINTNET -1 | | | This if for use if you're a Bossnode. Set the network address the message is to be re-routed to. So, if you have Pointnet set to -1, and your address is 109/315, and a message is found addressed to 109/315.2, the message would be automagically re-routed to -1/2. Opus seems to do points just great with the YAHOO/Wazoo protocol when the Network address is -1! --------+------------+----------+------------------------------------------- -n | NORMAL | N | | | | Normalize all packets in the holding area, so that those that are left with the LEAVE verb are sent. --------+------------+----------+------------------------------------------- -x | MAXARC | N | In OMMM.cfg: MAXARC 512K | | | On command line: -x512 This command lets you specify how big the bundles may be before a new bundle is started. The default is no limit. --------+------------+----------+------------------------------------------- -t | OLDBUNDLE | N | In OMMM.cfg: OLDBUNDLE 7 | | | On command line: -t9 This enables you to let OMMM take care of deleting mail that's been sitting in your hold area for a specified number of days. Use the command with a specific number of days immediately following the -t with no spaces between. In first example, OMMM would delete mail after 7 days, and the second example would delete after 9 days. --------+------------+----------+------------------------------------------- -d | NO_DATE | N | | | | OMMM supports the time/date stamp converting of Opus messages into FTSC format for outbound mail. This option is used to DISable this, which you should only use if you're not using an Opus compatible message editor. OMMM 1.70 - Index A Page 30 --------+------------+----------+------------------------------------------- Switch | Name | Required | Examples --------+------------+----------+------------------------------------------- -r | NAKED | N | | | | Used to generate file requests with mailers that treat .REQ files as normal mail. (See Index B for file extensions). Using this option will create "naked" file requests, which are understandable by Binkley. If you're NOT running Binkley, don't use this option. --------+------------+----------+------------------------------------------- -y | REQUEST | N | | | | With Opus 1.2x, this command will let you specify the new Opus file requesting options. --------+------------+----------+------------------------------------------- -z | OZONE | N | | | | This toggle will let you hold off on processing Zone mail. With this option, mail in your matrix area will NOT be scanned. Use this only if you don't want mail addressed to other zones scanned. 3 THINGS TO FILE IN YOUR BRAIN (Somewhere under C:\OPUS\OMMM\MISC): 1. If you choose to use any of the command line switches that require a name input (like MESSAGEPATH or HOLDPATH), make sure you fully path the name on the control line. See the examples here. 2. DOS requires that the full command line be ONE line. So, if you choose to do your command line input from a batch file, remember that all commands must be on the same line. 3. Once again, remember that all command line switches override whatever you've set in the OMMM.cfg. OMMM 1.70 - Index A Page 31 Index B - File Extensions ========================= Below is a chart that shows all the mail packet extensions, and what type of mail packet they're used for. You DON'T need to know how to work with these, as OMMM will handle that for you. This is just for your reference. When NOT using the LEAVE verb: +------------+------------+------------+------------+ | Flow | Flow | NonStuffed | NonStuffed | | | with | | with | | File | Request | Mail | Request | +---------+------------+------------+------------+------------| | | | | | | | Normal | FLO | FRO | OUT | ORT | |---------+------------+------------+------------+------------| | | | | | | | Crash | CLO | CRO | CUT | CRT | |---------+------------+------------+------------+------------| | | | | | | | Direct | DLO | DRO | DUT | DRT | |---------+------------+------------+------------+------------| | | | | | | | Hold | HLO | HRO | HUT | HRT | +-------------------------------------------------------------+ When USING the LEAVE verb: +---------------------------------------------------+ | Flow | Flow | NonStuffed | NonStuffed | | | with | | with | | File | Request | Mail | Request | +---------+------------+------------+------------+------------| | Normal | | | | | | Crash | NLO | NRO | NUT | NRT | | Direct | | | | | | Hold | | | | | +-------------------------------------------------------------+ Additional extensions are: REQ - Opus style file request. NRQ - Binkley style file requests using NAKED (-r) option. $$? - File created by your mailer to keep track of how many bad connects have been made to a system. These are calls where you would be charged because the phones DID connect, but were unable to exchange mail. Opus will mark this board "undialable" and stop calling it it after 5 attempts. You can "clear undialables" via an outbound manager or the Opus Matrix Menu. MO? - Compressed mail packet for either old style (using MO? or -o option). Or a Monday packet, using the new style. TU?, WE?, etc are packet names using new style format. OMMM 1.70 - Index B Page 32 Index C - Schedule Verbs ======================== SCHED MEANING: This is the most important schedule command, because it tells OMMM that it's the beginning of all the commands for that schedule. For Example: EXAMPLE: SCHED <letter> (In OMMM.cfg or RouteFile) -s<letter> (On command line) SCHED C -sC tells OMMM that this is the start of schedule <letter>, and for it to run all of the following commands, IN OR- DER, until it reaches another SCHED line. You use this verb in your OMMM, or in your RouteFile to mark the beginning of list of verbs to be run when that schedule is called. POLL MEANING: This tells your board to call the board you've specified. EXAMPLE: POLL <Net/Node> POLL 129/112 will cause your board to call the board you've specified when that schedule is run. Remember, your board will call any board you specify if it finds the number from your nodelist files. However, if you've got mail on hold for that board, OMMM won't send that mail unless you UNHOLD it first. If you're holding mail to send to another system at a cheaper phone rate, make sure you UNHOLD it before you poll that board. HOW IT WORKS: The POLL command creates a dummy ????????.FLO file, if no .FLO, .CLO, or .DLO extensioned file exists. Opus recognizes these extensions as a file to be sent, so calls the board specified, and picks up any mail there for you (unless that Sysop used the LEAVE command). OMMM 1.70 - Index C Page 33 PASSWORD MEANING: Using this command will encrypt a password into the compressed mail packet. This means that the board receiving this packet must be able to uncompress the mail, AND must also have the password set up at that end. EXAMPLE: PASSWORD <Net/Node> <password> PASSWORD 129/112 PARANOID HOW IT WORKS: Encrypts a password into the *.MO? (.TU?, WE?, etc if using new extension names), so that the receiving board must also have the correct password setup at their end to un-compress and toss the mail. HOSTROUTE MEANING: Using this command will automagically have OMMM address a mail bundle FROM the board to whom it's addressed TO the board that serves as the "host" for that net. The NetWork CoOrdinators of each net serve as the "host" of the net, and presumably would have their boards setup to send the mail to the final ad- dressee at the correct time of day. So, what you're doing when using this command is sending a message to someone via their NC. If you choose to use this command, please keep in mind the fact that while most NCs can call all boards in their net as a local call, some boards may be a toll call for them. EXAMPLE: HOSTROUTE <Net/Node> HOSTROUTE 129/112 In the above example, all mail slated for 129/112 would be routed through 129/0. This command is from the days when many boards didn't support continuous mail, and so mail was routed through the host of the net. It was assumed that Hosts would be setup to send the mail at a time when the final destination board could accept it. OMMM 1.70 - Index C Page 34 HOW IT WORKS: Using HOSTROUTE causes OMMM to rename the file with the Host's board number, rather than the final des- tination boards' number. If you were to use the above example and HostRoute a message to 129/112, OMMM would change the name of the file from: 00810070.HLO (129/112 in Hexidecimal) to: 00810000.HLO (129/0 in Hexidecimal) All Hosts are <Net/0>. NOTE: If you're a Network CoOrdinator/Host, make sure you've setup your schedules to include a time to forward mail for your net. LEAVE MEANING: This verb is very similar to the HOLD verb, with one major exception: Mail that has been marked LEAVE can NOT be picked up if the destination board should call yours. The LEAVE verb renames the exten- sion of the file to one that Opus won't recognize The bundle won't be sent by your board, nor can it be picked up by the destination board. To Opus, a LEAVE packet doesn't exist. EXAMPLE: LEAVE <Net/Node> LEAVE 129/ALL 371/18 HOW IT WORKS: Renames: ????????.FLO ????????.CLO } to ????????.NLO ????????.DLO ????????.HLO } ????????.FRO ????????.CRO } to ????????.NRO ????????.DRO ????????.HRO } ????????.OUT ????????.CUT } to ????????.NUT ????????.DUT ????????.HUT } ????????.ORT ????????.CRT } to ????????.NRT ????????.DRT ????????.HRT } The NLO, NRO, NUT and NRT extensions don't mean any- thing to Opus, so the renamed file is not sent, and cannot be picked up. OMMM 1.70 - Index C Page 35 SEND MEANING: Used as an "Un-Leave", this verb causes a packet that's been marked as LEAVE to now be sendable, and pickup-able (is that a word?). The SEND verb will change the LEAVE packet to a normal packet, so if you want to remove a packet from it's LEAVE state, and have it then be on HOLD, you must SEND it, then HOLD it. EXAMPLE: SEND <Net/Node> SEND 129/ALL 371/18 HOW IT WORKS: Renames: ????????.NLO to ????????.FLO ????????.NRO to ????????.FRO ????????.NUT to ????????.OUT ????????.NRT to ????????.ORT OMMM 1.70 - Index C Page 36 There are also twelve other verbs available to you, and though listed after those above, they're actually the most common used. These twelve are HOLD, CRASH, and DIRECT, along with the pre- fixes UN-, ONE- and NORM-. HOLD will mark a packet (by changing it's extension), so that the mail is NOT sent, but can be picked up by the desti- nation board. CRASH will tell your board that this mail should go out immediately, and your board will begin calling the des- tination as soon as the caller hangs up. DIRECT will tell your board that this mail is slated for a sys- tem that doesn't support continuous mail. UN- Will reverse the verb it's used as a prefix for. ONE- Compresses the mail, and creates separate packets for each board in the line. So ONEHOLD 129/ALL will com press mail being sent to any board in Net 129, create a separate marker file for each, and put all of the pack- ets on HOLD. NORM- Will NOT compress the mail, but will create a marker file for the destination board, and then follow the in- structions of the verb it's a prefix for. The next page of these docs gives you a chart of these verbs, and their prefixes, for your viewing pleasure. Each verb has the same syntax: COMMAND <Net/Node> [Net/Node] [Net/Node] So: HOLD 129/112 ONEHOLD 371/18 129/112 129/50 are both valid lines in a schedule. OMMM 1.70 - Index C Page 37 +-----------------+-----------------+-----------------+ | UN- | ONE- | NORM- | +--------------------+-----------------+-----------------+-----------------+ | HOLD | UNHOLD | ONEHOLD | NORMHOLD | | | | | | | Mail is compressed | Change a HOLD | Compresses the | Mail is NOT | | and addressed, but | packet to a | mail, and makes | compressed, but | | after that, your | normal packet | a marker file | IS addressed, | | board will ignore | by changing the | telling the | then marked as | | it. The mail will | "marker" file | board that the | HOLD. | | sit until: | extention. | mail is to be | | | 1. You UNHOLD it. | | put on HOLD. | | | 2. The destination | | | | | board calls and | | | | | picks it up. | | | | | 3. It's deleted as | | | | | as an OLDBUNDLE.| | | | | 4. You delete it | | | | | manually. | | | | +--------------------+-----------------+-----------------+-----------------+ | CRASH | UNCM | ONECM | NORMCM | | | | | | | Opus will try | Change a CRASH | Compresses the | Mail is NOT | | to send this | packet to a | mail, and makes | compressed, but | | mail immediately. | normal packet | a marker file | IS addressed, | | Opus 1.1x & 1.2x | by changing the | telling the | then marked as | | will allow callers | "marker" file | board that the | CRASHED. | | to log onto the | extention. | mail is to be | | | board between | | CRASHED. | | | tries, while Opus | | | | | 1.03 will do it's | | | | | best to keep | | | | | calling out. All | | | | | Opus versions will | | | | | keep calling to | | | | | send until they | | | | | get the packet | | | | | through, or get | | | | | 5 unsuccessful | | | | | connects. | | | | +--------------------+-----------------+-----------------+-----------------+ | DIRECT | UNDIRECT | ONEDIRECT | NORMDIRECT | | | | | | | This command is | Change a DIRECT | Compresses the | Mail is NOT | | used for systems | packet to a | mail, and makes | compressed, but | | that you know | normal packet | a marker file | IS addressed, | | can't receive | by changing the | telling the | then marked as | | continuous mail, | "marker" file | board that the | DIRECT. | | and those you're | extention. | mail is to be | | | not sure about. | | a DIRECT packet.| | | It serves as an | | | | | excellant "catch | | | | | all" at the end | | | | | of a schedule. | | | | +--------------------+-----------------+-----------------+-----------------+ OMMM 1.70 - Index C Page 38 Index D - Decimal/Hexidecimal Conversion Chart ============================================== DEC HEX DEC HEX DEC HEX DEC HEX 1 - 1 26 - 1A 51 - 33 76 - 4C 2 - 2 27 - 1B 52 - 34 77 - 4D 3 - 3 28 - 1C 53 - 35 78 - 4E 4 - 4 29 - 1D 54 - 36 79 - 4F 5 - 5 30 - 1E 55 - 37 80 - 50 6 - 6 31 - 1F 56 - 38 81 - 51 7 - 7 32 - 20 57 - 39 82 - 52 8 - 8 33 - 21 58 - 3A 83 - 53 9 - 9 34 - 22 59 - 3B 84 - 54 10 - A 35 - 23 60 - 3C 85 - 55 11 - B 36 - 24 61 - 3D 86 - 56 12 - C 37 - 25 62 - 3E 87 - 57 13 - D 38 - 26 63 - 3F 88 - 58 14 - E 39 - 27 64 - 40 89 - 59 15 - F 40 - 28 65 - 41 90 - 5A 16 - 10 41 - 29 66 - 42 91 - 5B 17 - 11 42 - 2A 67 - 43 92 - 5C 18 - 12 43 - 2B 68 - 44 93 - 5D 19 - 13 44 - 2C 69 - 45 94 - 5E 20 - 14 45 - 2D 70 - 46 95 - 5F 21 - 15 46 - 2E 71 - 47 96 - 60 22 - 16 47 - 2F 72 - 48 97 - 61 23 - 17 48 - 30 73 - 49 98 - 62 24 - 18 49 - 31 74 - 4A 99 - 63 25 - 19 50 - 32 75 - 4B 100 - 64 Since running in multiple Zones requires multiple outbound di- rectories, and these directories must have the HEXIDECIMAL rep- resentation of the Zone, use this chart to find the correct number. You don't need to add any extension to your primary zone outbound, as your primary will work out of C:\OPUS\OUTBOUND. However, if you're running with additional Zones, you must create a separate subdirectory for each, with the decimal Zone number represented in Hex format as the directory extention. For example, if your primary address is in zone 1, mail for that Zone would be handled by C:\OPUS\OUTBOUND. If you also have a Zone 69 address, you would need to create an Outbound subdirectory with the 69 represented in hex form. So, you would need to create C:\OPUS\OUTBOUND.045 to handle your Zone 69 mail. Conversely, if your primary Zone is Zone 69, and your aka is Zone 1, then C:\OPUS\OUTBOUND would handle your Zone 69 mail (since it's your primary Zone), but you'd need to create C:\OPUS\OUTBOUND.001 to handle your Zone 1 mail. OMMM 1.70 - Index D Page 39 Legal Department ================ This documentation includes the names of many different program- mers, and their programs. Listed below are the names of the programs/programmers/organizations/persons who have had their efforts mentioned, or quoted. Arc, Arca, Arce.........Vernon Buerg, Wayne Chin, System Enhancement Associates, Inc. Binkley/BinkleyTerm.....Bit Bucket Software Fido....................Tom Jennings, Fido Software Lharc...................Haruyasu Yoshizaki oMAN....................Tom Kashuba Opus CBCS...............Wynn Wagner III Pak.....................NoGate Consulting PkWare/PkZip/PkUnzip....Phil Katz, PKWare, Inc. Zoo.....................Rahul Dhesi Very special thanks to Wynn Wagner III, Jon Sabol and Jon Mar- shall for their kind permission in allowing me to quote them in these docs. Special thanks to Chuck Ammon, Joe Fossati, Paul Kelly, Gary Rickman, and Stu Turk for allowing me to use their NetNumbers in the examples given here. It just so happens that it was Chuck, Joe and Stu who helped me setup my own board a long time ago in a galaxy far, far away. OMMM - Software Version 1.70 by Jon Marshall, Based on the original OMMM, a portion of the Opus CBCS, copyright 1986 by Wynn Wagner III. Portions Copyright BS Software 1988, 1989 Portions Copyright John Valentyn, 1990 Portions Copyright Jon Marshall, 1990, 1991 OMMM - Documentation Version 1.70 documentation by Tina Dougherty, Copyright 1991. All rights reserved. All quotes used with permission. Portions Copyright Wynn Wagner III Portions Copyright Jon Sabol Portions Copyright Jon Marshall Stuffer<tm>, Stuffer Bundles<tm>, and Stuffed Mail<tm> are trademarks of the OMMM product. They may be used freely in a friendly and legal manner to describe compressed mail and file compression utilities. OMMM 1.70 - Legal Department Page 40 Glossary of Terms If you're unable to find the term you're looking for here, try the Indexes, then your DOS manual. 1.0x ................. Version of Opus. 1.1x ................. Version of Opus - 1.10 released 3/12/90. 1.2x ................. Version of Opus - 1.20 released 7/14/91. AKA ................. Also Known As - Used by boards that belong to more than one Net, so usually more than one zone. ARCA ................. Compression Method. ARCE ................. Un-Compression Method. ARCMAIL .............. Term for mail packet that's been compressed. ASCII ................ Straight readable text. BBS.CTL .............. Text control file for Opus. BBS.PRM .............. Machine readable control file for Opus. BOSSNODE ............. A board that is running Points. CONFIG ............... A file of parameter commands read by the executable program. COMPRESSED............ File made smaller in size by a program written for that purpose. DOC .................. Documentation, instructions. EDLIN ................ DOS's text editor. FTSC ................. FidoNet Technical Standards Committee. GOTO ................. Command used in batch files to direct execution of the lines. (See "Setting Up Errorlevels" and your DOS manual). HEXIDECIMAL .......... Base 16 mathematics. INTERZONE ............ Between Zones. INTRAZONE ............ Within the same Zone. LHARC ................ Compression Program. MAXLINES.............. Maximum number of lines for a message in any message area. Configurable in BBS.Ctl. MATRIX MAIL (NETMAIL). Mail sent between 2 boards. NCs .................. NetWork CoOrdinators. NECs.................. NetWork Echo CoOrdinators. NERF.BAT ............. A present to WWIII from the boss to prevent damage to the equipment. Also the common name of the batch file that's used to run Opus. NET/NODE NUMBER....... Your Net Number and Node number: Basic Example: 371/15 With zone and point specifications: 1:371/15.0 (Zone:Net/Node.Point) NODEDIFF ............. Weekly update to Nodelist. NODELIST ............. List of all boards currently having NetNode numbers in that particular group of Nets. Fido uses Nodelist, EggNet uses EggList, etc. NON-STUFFED .......... Mail that's not been compressed. OMMM ................. Opus Matrix Message Masher. OMMM.cfg ............. Configuration File for OMMM. PAK .................. Compression/Un-Compression program. PKZIP/PKUNZIP ........ Compression/Un-Compression program. OMMM 1.70 - Glossary Page 41 POINT..................A board which is running under the direc- tion of a "BossNode". A Point board does not have it's own net number, but gets all echo mail through their boss. PRESCAN .............. Scanning all mail prior to running OMMM. PRESCAN FILE ......... File that gives commands for PreScanning. PROCEDURAL ........... To run in order. Step 1 then 2 then 3, etc. ROUTEFILE ........... OMMM file that can hold all scheduling info. ROUTE.CTL ............ A sample RouteFile name. RUNOPUS.BAT .......... Optional name for a batch file that runs your Opus board. See: NERF.BAT STUFFER <tm>.......... OMMM command to work with any compression program. SYSOP ................ System Operator, runs the board. UN-COMMENTING ........ To delete the symbol in front of a command in a config file. This enables the program to read it. UNDIALABLES .......... A board that Opus has connected to 5 times, but has been unable to exchange mail all 5 times. Opus will not attempt to call this board again, unless you "Clear Undialables" either from Opus's Matrix Menu, or with an Outbound Area Manager. UNROUTED ............. Mail that hasn't been directed to it's destination. UN-COMPRESSING ....... Opening up a compressed file. UN-LEAVE ............. Use of the SEND verb to change a LEAVE packet to a normal packet. YAHOO/Wazoo .......... Opus protocol. ZONE.................. First number in a full NetNumber. In FidoNet, this specifies geographic area. For example, North America is Zone 1, Europe is Zone 2 and Australia is Zone 3. In groups other than FidoNet, it specifies the group itself. For example EggNet is Zone 99. OMMM 1.70 - Glossary Page 42